home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 May / EnigmA AMIGA RUN 18 (1997)(G.R. Edizioni)(IT)[!][issue 1997-05][EAR-CD II].iso / earcd / misc / emu / arosdev.lha / AROS / rom / utility / freetagitems.c < prev    next >
C/C++ Source or Header  |  1997-01-27  |  2KB  |  92 lines
  1. /*
  2.     $Id: freetagitems.c,v 1.7 1997/01/27 13:17:13 digulla Exp $
  3.     $Log: freetagitems.c,v $
  4.     Revision 1.7  1997/01/27 13:17:13  digulla
  5.     Added #include <proto/exec.h>
  6.  
  7.     Revision 1.6  1997/01/27 00:32:31  ldp
  8.     Polish
  9.  
  10.     Revision 1.5  1996/12/10 14:00:13  aros
  11.     Moved #include into first column to allow makedepend to see it.
  12.  
  13.     Revision 1.4  1996/10/24 15:51:35  aros
  14.     Use the official AROS macros over the __AROS versions.
  15.  
  16.     Revision 1.3  1996/09/13 17:36:37  digulla
  17.     Use IPTR
  18.  
  19.     Revision 1.2  1996/09/12 14:52:47  digulla
  20.     Better way to separate public and private parts of the library base
  21.  
  22.     Revision 1.1  1996/08/31 12:58:12  aros
  23.     Merged in/modified for FreeBSD.
  24.  
  25.     Desc: FreeTagItems()
  26.     Lang: english
  27. */
  28. #include <proto/exec.h>
  29. #include "utility_intern.h"
  30.  
  31. /*****************************************************************************
  32.  
  33.     NAME */
  34. #include <utility/tagitem.h>
  35. #include <proto/utility.h>
  36.  
  37.     AROS_LH1(void, FreeTagItems,
  38.  
  39. /*  SYNOPSIS */
  40.     AROS_LHA(struct TagItem *, tagList, A0),
  41.  
  42. /*  LOCATION */
  43.     struct UtilityBase *, UtilityBase, 13, Utility)
  44.  
  45. /*  FUNCTION
  46.     Free a list of TagItems which was allocated by AllocateTagItems().
  47.  
  48.     INPUTS
  49.     tagList     - A list of TagItems - must have been allocated by
  50.               AllocateTagItems() or CloneTagItems().
  51.  
  52.     RESULT
  53.     The memory containing the tagList is returned to the system.
  54.  
  55.     NOTES
  56.     The memory will only be freed if the input is non-NULL.
  57.  
  58.     EXAMPLE
  59.     struct TagItem *tagList;
  60.  
  61.     tagList =  AllocateTagItems( 4 );
  62.  
  63.     tagList[0].ti_Tag  = NA_Name;
  64.     tagList[0].ti_Data = (IPTR)"A list of tags";
  65.     tagList[3].ti_Tag  = TAG_DONE;
  66.  
  67.     \* Do what you want with your TagList here ... *\
  68.  
  69.     FreeTagItems( tagList );
  70.  
  71.     BUGS
  72.  
  73.     SEE ALSO
  74.     utility/tagitem.h, utility/AllocateTagItems()
  75.  
  76.     INTERNALS
  77.  
  78.     HISTORY
  79.     29-10-95    digulla automatically created from
  80.                 utility_lib.fd and clib/utility_protos.h
  81.     11-08-96    iaint   Moved into AROS source tree.
  82.  
  83. *****************************************************************************/
  84. {
  85.     AROS_LIBFUNC_INIT
  86.  
  87.     if( tagList )
  88.     FreeVec( tagList );
  89.  
  90.     AROS_LIBFUNC_EXIT
  91. } /* FreeTagItems */
  92.